home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 May / Macworld (1999-05).dmg / MkLinux-DR3 / Read Me files / README_DR3 < prev   
Text File  |  1998-12-12  |  38KB  |  867 lines
  1. Table of Contents
  2. =================
  3.  
  4.     Introduction
  5.  
  6.     Machine List
  7.  
  8.     Partitioning your Hard Disk
  9.         Basic partitioning information
  10.         Estimating space requirements
  11.         Partitioning your disk(s)
  12.         Repartitioning Existing Disks
  13.         Partition Types and Names
  14.         Drive Setup
  15.         Apple HD SC Setup
  16.         pdisk
  17.  
  18.     Installing the Mac OS-side files
  19.  
  20.     Once you are in the MkLinux Installer
  21.  
  22.     Getting started with MkLinux
  23.         Logging in as root
  24.         Creating a user account
  25.         Mounting the CD
  26.         Installing a package
  27.         Removing a package
  28.  
  29.     Where to go next
  30.         Books
  31.         Online
  32.  
  33.     Thanks
  34.  
  35.     Last words
  36.  
  37.  
  38. Introduction
  39. ============
  40.  
  41. Welcome to MkLinux Developer Release 3!  MkLinux, as you probably realize, is
  42. Apple Computer's Mach 3-based version of the GNU/Linux operating system.
  43. Versions of MkLinux run on the Intel, PA-RISC, and PowerPC architectures.
  44. This disc contains the version of MkLinux which runs on PowerPC-based Apple
  45. Power Macintosh and related systems.
  46.  
  47. With DR3, MkLinux binary executables are compatible with the other PowerPC
  48. Linux systems (e.g., LinuxPPC).  In addition, MkLinux file systems are byte-
  49. order compatible with other (e.g., Intel-based) Linux file systems.  Also,
  50. MkLinux DR3 supports dynamic shared libraries, for greatly reduced disk and
  51. RAM storage and faster program loading.
  52.  
  53. Developer Release 3 has been a long time (over a year!) in development.  It
  54. supports many more machines since the last release (DR2.1) and offers much
  55. more flexibility in terms of installation options.  As a result of this
  56. flexibility, the installation process has become rather more complex.  We have
  57. tried to retain as much simplicity as possible, however!
  58.  
  59. If, after reading these notes carefully, you still have trouble getting
  60. MkLinux to run, please make use of the wide variety of user-contributed
  61. support resources.  Specifically, you should start with the "Frequently Asked
  62. Questions" (FAQ) on Apple's MkLinux web page (www.mklinux.apple.com).
  63.  
  64. If the FAQ does not help you, please use the MkLinux mailing lists.  The
  65. "mklinux-setup" list is probably most appropriate for problems you might
  66. encounter while installing MkLinux DR3.  Submit your question (in detailed
  67. form) to the mklinux-setup email list (the MkLinux web site has links to a
  68. sign-on form).  The members on the setup list are very helpful and
  69. knowledgeable about a wide range of machines.
  70.  
  71. Please do not contact directly Apple Computer's MkLinux team or Prime Time
  72. Freeware for support on MkLinux.  Put simply, neither organization has the
  73. resources to help you.  You will get better results with the FAQ and mailing
  74. lists.
  75.  
  76.  
  77. Machine List
  78. ============
  79.  
  80. MkLinux DR3 will run on the following PowerPC-based Macintoshes:
  81.  
  82.     Power Macintosh  6100                    Power Macintosh  9500
  83.     Performa         61xx                    Power Macintosh  9500/180MP
  84.     Workgroup Server 6150                    Power Macintosh  9515
  85.     Power Macintosh  7100                    Power Macintosh  9600
  86.     Power Macintosh  8100                    Power Macintosh  9600/200MP
  87.     Power Macintosh  8115                    Workgroup Server 9650
  88.     Workgroup Server 8150
  89.     Workgroup Server 9150                    Power Macintosh  4400
  90.                                              Power Macintosh  5400
  91.     Power Macintosh  7200                    Performa         54xx
  92.     Power Macintosh  7215                    Power Macintosh  5500
  93.     Power Macintosh  7220                    Performa         6360
  94.     Workgroup Server 7250                    Power Macintosh  6400
  95.     Power Macintosh  7300                    Performa         64xx
  96.     Workgroup Server 7350                    Power Macintosh  6500
  97.     Power Macintosh  7500                    20th Anniversary Macintosh
  98.     Power Macintosh  7600
  99.     Power Macintosh  8200                    PowerBook 3400
  100.     Power Macintosh  8500                    Power Macintosh G3 Desktop
  101.     Power Macintosh  8515                    Power Macintosh G3 Minitower
  102.     Workgroup Server 8550                    PowerBook G3
  103.     Power Macintosh  8600
  104.  
  105. Notes:
  106.  
  107. Some of the high-end Power Macintoshes and Workgroup Servers use a PCI-based
  108. SCSI adapter to access Fast-Wide or Ultra-Wide SCSI devices.  At this time,
  109. MkLinux cannot access SCSI devices attached via PCI adapters.  In order to use
  110. MkLinux DR3 on these machines, you will need to attach a separate SCSI disk to
  111. the Macintosh's onboard or external SCSI connector.
  112.  
  113. MkLinux has some difficulty accessing various IDE drives that have been
  114. shipped on some Macintosh systems.  MkLinux will not recognize these drives;
  115. thus, the MkLinux installer will not report them in its drive list.  As an
  116. alternative, you can install MkLinux DR3 onto an external SCSI drive.  Check
  117. the Frequently Asked Questions on www.mklinux.apple.com for current
  118. information, patches, workarounds, etc.
  119.  
  120. MkLinux DR3 will run on many of the Macintosh clones.  If you have one of
  121. these machines, your best bet is to try the installation process and see how
  122. things go.  If you have problems, send a note to the mklinux-setup list.
  123.  
  124.  
  125. Partitioning your Hard Disk
  126. ===========================
  127.  
  128. Partitioning your disk is probably the most difficult step in getting MkLinux
  129. installed onto your Macintosh.  If you are already familiar with partitioning
  130. disks on Macintosh systems, you should at least skim this section and proceed
  131. with your own partitioning method.
  132.  
  133. Unfortunately, there is no simple partitioning recipe that will work for every
  134. situation.  Practically every MkLinux installation is unique; each may
  135. require different tools and methods to accomplish.  The best we can do is to
  136. provide you with information about partitioning tools and MkLinux's
  137. requirements, then let you determine which method best serves your needs.
  138.  
  139. If you are new to disk partitioning concepts, or partitioning disks on
  140. Macintoshes, then you will want to pay close attention to this section.  Even
  141. if you are completely unfamiliar with disk partitioning concepts, we feel that
  142. if you read this section carefully, you _will_ be able to get through the
  143. partitioning task.  Don't give up, it's really not that difficult.  Also,
  144. you may want to make use of the helpful people who read and post to the
  145. mklinux-setup mailing list.
  146.  
  147. Basic partitioning information
  148. ------------------------------
  149.  
  150. Most of the disk space that MkLinux needs in order to operate does not reside
  151. in regular Mac OS volumes.  Instead, MkLinux has its own filesystems, which
  152. must reside in separate disk partitions.
  153.  
  154. MkLinux uses two distinct types of disk partitions.  It uses "swap" space to
  155. store idle portions of the memory used by running programs.  It uses
  156. "filesystem" space to store directories (i.e., folders) and files.
  157.  
  158. The amount of swap space MkLinux needs depends on what sorts of tasks the
  159. machine will be doing and how much physical RAM you have installed.  The swap
  160. space is combined with the physical RAM in the system to produce the total
  161. amount of virtual memory available for all running programs.  The minimum
  162. amount of swap space that the MkLinux DR3 install process will allow is 8 MB.
  163. Typically, 64 MB of swap space is just fine.
  164.  
  165. If you have very little RAM or expect to be running many users or programs at
  166. once, you may want to provide more swap space.  Please keep in mind that the
  167. maximum usable size of a MkLinux swap partition is 128 MB.  You are free,
  168. however, to have more than one swap partition.
  169.  
  170. The MkLinux filesystem has (like Mac OS) a hierarchical directory structure:
  171. files may exist at any level of the directory hierarchy.  Unlike Mac OS,
  172. however, MkLinux can graft whole filesystem trees (residing in separate
  173. partitions) onto the main ("root") filesystem.
  174.  
  175. This grafting ability, modelled after UNIX, is called "mounting" a filesystem.
  176. The directory under which the mounted filesystem appears is called a "mount
  177. point".  By carefully choosing the sizes of your filesystem partitions and
  178. their mount points, you can create a unified filesystem tree with branches
  179. existing in separate partitions or even separate disk drives.
  180.  
  181. MkLinux filesystem partitions are limited, at present, to a maximum of two GB
  182. each.  Therefore, if you want to have an overall MkLinux filesystem that will
  183. hold more than 2 GB, you'll need to use multiple partitions.
  184.  
  185. How you envision using your MkLinux system will help determine where you might
  186. consider mounting extra filesystems.  For example, if you expect that you will
  187. be loading many extra programs (or packages) after your initial MkLinux
  188. install, you might want to dedicate a whole partition to the "/usr" portion
  189. of your filesystem.  If you expect to have several users, you may want to let
  190. "/home" (and its subdirectories) reside in its own partition.  If you expect a
  191. large amount of email or Usenet news to flow through the system, consider
  192. giving "/var" its own partition.
  193.  
  194. Finally, if you're not sure how your system will be used, or which areas of
  195. the filesystem might need their own partition, you can simply put the whole
  196. MkLinux filesystem into one partition.  The 2 GB rule mentioned above still
  197. applies, but a single partition filesystem is all you need to get started.
  198.  
  199. Estimating space requirements
  200. -----------------------------
  201.  
  202. The MkLinux DR3 CD contains 420 packages that can be installed initially and
  203. 233 "extra" packages which can be installed later, as desired.  The initial
  204. installation process provides quite a bit of flexibility in choosing which
  205. of the initial 420 packages to install.  Follow-on installation is even more
  206. flexible, allowing any desired package(s) to be installed.
  207.  
  208. It would be ridiculous for us to list the disk space requirements of every
  209. combination allowed by the initial installation.  So, we will provide the
  210. space requirements for three typical MkLinux installations.
  211.  
  212. The MkLinux installer has a page where you choose several broad categories of
  213. packages to be installed.  The install configuration called "Absolute Minimum"
  214. unchecks (de-selects) every option on the selection page.  "Default
  215. Selections" makes no changes on the selections page.  "Everything" installs
  216. all 420 packages.
  217.  
  218.   partition  "Absolute Minimum"     "Default Selections"       "Everything"
  219.   -------------------------------------------------------------------------
  220.   /                  15                     15                      16
  221.   /opt                0                     33                      47
  222.   /usr               41                    136                     398
  223.   /var                2                      4                      10
  224.   /home               0                      0                       3
  225.   -------------------------------------------------------------------------
  226.   totals             58                    188                     474
  227.  
  228. All values are in Megabytes (where 1 Megabyte = 1024*1024 bytes).
  229.  
  230. Given the five partitions shown above, the table shows the space usage in the
  231. partition after each of the three separate installations.  It is not necessary
  232. for you to create all five of these MkLinux filesystem partitions.  In fact,
  233. the "/opt" partition is not found on most Linux installations.
  234.  
  235. In general, you will want to have fewer partitions in your installation than
  236. the five shown above.  As you eliminate partitions, incorporate their space
  237. into that of the root partition (labelled "/" in the table).
  238.  
  239. To help you get started, we will walk through two common examples.  An
  240. "Everything" installation, using the three partitions "/", "/usr", and
  241. "/home", will require at least 73 MB for "/", 398 MB for "/usr", and 3 MB for
  242. "/home".  A "Default Selections" installation, with a single filesystem
  243. partition, will require at least 188 MB in that ("/") partition.
  244.  
  245. Of course, you will want to leave some extra space in your filesystems so that
  246. you can actually use your MkLinux system without running out of space on the
  247. first day!  If you will be installing some of the 233 "extra" packages on the
  248. CD, then you should increase the amount available in "/usr", as most of those
  249. packages install files somewhere under the "/usr" directory.
  250.  
  251. If you want to add several user accounts to your system so that your friends
  252. can log in, you will want to have plenty of space available for "/home" to
  253. grow.  "/home" is also the default location of any "anonymous FTP" space or
  254. web pages that you may want to host on your MkLinux system.  If you expect
  255. your MkLinux system to be handling lots of email or Usenet news, ensure that
  256. the "/var" directory has plenty of room to grow.
  257.  
  258. Hopefully, you now have some idea of what partitions you will want for
  259. MkLinux.  The next step is to actually make these MkLinux partitions.
  260.  
  261. Partitioning your disk(s)
  262. -------------------------
  263.  
  264. There are three partitioning programs included on this CD.  Each has its
  265. strengths and weaknesses when applied to the task of partitioning your disk
  266. for MkLinux.  These differences are discussed below.  However, before we
  267. begin, it is important that you understand some of the basic concepts of disk
  268. partitioning on Macintosh systems.
  269.  
  270. Whether you realize it or not, your system disk is already partitioned.  Most
  271. of the space on your disk is probably allocated to one partition that contains
  272. a large Mac OS volume.  There are several smaller partitions, however, which
  273. hold other bits of information:
  274.  
  275.  * There is exactly one "Partition Map" partition which holds the
  276.    partitioning information itself.
  277.  
  278.  * There is probably at least one "Driver Partition" which enables Mac OS
  279.    to access the Mac OS volumes on the disk.
  280.  
  281.  * There may be a "Patch Partition" which has been used to store patches to
  282.    the Mac OS operating system.
  283.  
  284.  * Finally, any "free" space must be accounted for in other partitions.
  285.  
  286. Partitions are contiguous areas on your disk.  Filesystems are data structures
  287. that exist inside partitions.  Mac OS Standard (also known as HFS) and Mac OS
  288. Extended (also known as HFS+) volumes are two types of filesystems that may
  289. exist in partitions.
  290.  
  291. If you open a volume on your desktop and see something like "353.3 MB in disk
  292. 844.7 MB available", the 844.7 MB is unused space _inside_ that Mac OS
  293. filesystem.  The message does NOT refer to free partition space.  To find out
  294. if you have free partition space on your disk, you will need to use a tool
  295. (such as a partitioner) that looks at the actual partition map.
  296.  
  297. Repartitioning Existing Disks
  298. -----------------------------
  299.  
  300. Although (for safety!) we recommend the use of a separate disk for MkLinux,
  301. this is not absolutely necessary.  It is possible to repartition your existing
  302. disk, shrink the Mac OS portion, and install MkLinux in the remaining space.
  303.  
  304. In most instances, however, shrinking your existing Mac OS volume (and the
  305. surrounding partition) will require that the Mac OS volume be reinitialized,
  306. destroying everything you may have in the volume.  Obviously, you would want
  307. to back up all your important files before destroying your existing volume!
  308.  
  309. It is possible to shrink a Mac OS volume (and the partition that contains it)
  310. while keeping the data intact.  The tools supplied in this MkLinux
  311. distribution cannot perform this task.  However, the task can be accomplished
  312. with at least one third-party disk partitioning program (FWB's Hard Disk
  313. Toolkit).  If this is an approach you would like to take, you will need to
  314. obtain HDT and use it to make free partition space.  You may use either HDT
  315. or the tools supplied on this CD to add the desired MkLinux partitions.
  316.  
  317. Partition Types and Names
  318. -------------------------
  319.  
  320. Every Macintosh partition has a "type" and a "name".  Both of these pieces of
  321. information are simple strings.  Usually, the name of a partition can be
  322. anything you want.  However, there are several important types that you should
  323. know about, including:
  324.  
  325.     Apple_partition_map     partition map
  326.     Apple_Driver43          disk drivers
  327.     Apple_Patches           Mac OS patches
  328.     Apple_HFS               Mac OS volumes
  329.     Apple_UNIX_SVR2         MkLinux partitions
  330.  
  331. Both standard (HFS) and extended (HFS+) Mac OS volumes are usually contained
  332. in partitions with the "Apple_HFS" type.  The name of an Apple_HFS partition
  333. may not be the same as the name of the Mac OS volume that it contains.
  334.  
  335. The names of the MkLinux filesystem partitions are ignored, so it's handy to
  336. name them for their intended purpose (e.g., root, home, usr, var, tmp, etc.).
  337. The MkLinux installer assigns partitions named "swap" for use as swap space.
  338.  
  339. This disc contains three partitioning programs, with varying capabilities:
  340.  
  341.     Drive Setup           standard Mac OS utility; partitions Apple drives
  342.                           (both IDE and SCSI); doesn't make A/UX (MkLinux)
  343.                           partitions
  344.  
  345.     Apple HD SC Setup     older Mac OS utility; partitions any SCSI drive;
  346.                           makes A/UX partitions
  347.  
  348.     pdisk                 Mac OS/Mklinux utility; makes A/UX partitions
  349.  
  350. Drive Setup
  351. -----------
  352.  
  353. Drive Setup is the standard partitioning utility that is shipped with Mac OS.
  354. It can create multiple MacOS partitions on your drive, leave free partition
  355. space (e.g., for use by pdisk), deposit the latest Apple disk drivers onto the
  356. disk, and create actual Mac OS standard and extended volumes in created
  357. partititions.  It can partition (Apple-branded) SCSI and IDE drives.
  358.  
  359. Drive Setup cannot create the A/UX-style partitions used by MkLinux.  One
  360. common method is to use Drive Setup to create free partition space on your
  361. drive, then use pdisk to create MkLinux partitions in the free space.  An
  362. alternative is to have Drive Setup create extra Mac OS partitions, then use
  363. pdisk to change them to MkLinux partitions before use.
  364.  
  365. Apple HD SC Setup
  366. -----------------
  367.  
  368. Apple HD SC Setup is an older partitioner from Apple that still comes in handy
  369. occasionally.  HD SC Setup originated in an era when Apple used SCSI drives
  370. exclusively.  Therefore it will not recognize your IDE drives.  It can,
  371. however, make A/UX partitions, as used by MkLinux.
  372.  
  373. By default, HD SC Setup will work on Apple drives only, but it can be
  374. patched (AT YOUR OWN RISK) to accept other drives:
  375.  
  376.     Copy Apple HD SC Setup 7.3.5 from the CD to a writable Mac OS drive.
  377.     Change the one byte in the "wfwr" ID 67 resource from "00" to "FF".
  378.  
  379. For more information, see www.euronet.nl/users/ernstoud/patch.html
  380.  
  381. pdisk
  382. -----
  383.  
  384. The pdisk partitioner was adapted from a Linux partitioner.  Pdisk can do
  385. practically anything to your partition table.  It runs on Apple-sanctioned as
  386. well as non-Apple drives.  Pdisk can even modify the partition table of the
  387. disk that you're currently running from.  However, pdisk has some problems.
  388.  
  389. The main problem is that pdisk is not a typical Mac OS application.  It has a
  390. command-line interface that can be intimidating to many.  Another disadvantage
  391. is that it does not do anything to areas of the disk other than the partition
  392. map.  Consequently it cannot install a driver onto your disk, nor can it
  393. create HFS or HFS+ volumes.  (However, it is important to note that it is not
  394. necessary to have a driver partition on a disk that doesn't have an HFS
  395. partition.)
  396.  
  397. Pdisk has two variants.  One is a program that runs under Mac OS.  The other
  398. is a MkLinux program that is available to you when the MkLinux installer is
  399. running.  The Mac OS version uses Mac OS facilities to access the disks;
  400. the MkLinux version uses MkLinux's facilities.  However, the "engine" in pdisk
  401. is the same between the two versions.  So, once you learn to use one, you will
  402. know how to use the other.
  403.  
  404. Even though it can be intimidating at first, we recommend that you learn
  405. enough of pdisk to at least display the partition table on a disk.  A good
  406. reference on how to use pdisk is located in the "pdisk.html" file in the
  407. "MacOS Utilities" folder on this disc.  Just point your favorite browser to
  408. the pdisk.html file.  Of all the partitioners mentioned, pdisk is the best one
  409. to show your disk's true partition layout.
  410.  
  411.  
  412. Installing the Mac OS-side files
  413. ================================
  414.  
  415. There are five files in the "Mac Files" folder.  Copy the two files "MkLinux
  416. Booter" and "Mach Kernel" to your Extensions folder.  Copy the control panel
  417. "MkLinux" to your Control Panels folder.  Copy the two files "lilo.conf" and
  418. "MkLinux.prefs" to your Preferences folder.
  419.  
  420. The initial boot of MkLinux just runs the installer.  Currently, things are
  421. set to install from a SCSI CD-ROM drive.  If your machine has a SCSI CD-ROM
  422. drive, you will not need to change anything.  Skip ahead a few paragraphs to
  423. where you "Restart your Macintosh".
  424.  
  425. If your machine has an ATAPI CD-ROM, then you will need to change a setting.
  426. If you have one of the following machines, you probably have an ATAPI CD-ROM
  427. drive:
  428.  
  429.     Power Macintosh 4400
  430.     Any "Tanzania" based clone
  431.     PowerBook 3400
  432.     PowerBook G3
  433.     Power Macintosh G3
  434.  
  435. To determine whether your machine has an ATAPI CD-ROM drive, insert a disc
  436. into your drive, click once on the disc's desktop icon, and run "Get Info"
  437. (from the File menu).  If the "Where:" line ends in "(ATAPI ..)", you have an
  438. ATAPI CD-ROM drive and you will need to change the rootdev setting.
  439.  
  440. To change MkLinux so that it will retrieve the installer from an ATAPI CD-ROM
  441. drive, launch the "MkLinux" control panel and select "Custom...".  SimpleText
  442. will be launched to edit your "lilo.conf" file.  Change your rootdev according
  443. to the instructions in the lilo.conf file.  (Basically, you will change a line
  444. so that it reads: "rootdev=/dev/hdc").
  445.  
  446. Restart your Macintosh.  Upon reboot, you should see the MkLinux "splash
  447. screen".  It is set to default boot into Mac OS.  Click on the "MkLinux"
  448. button, and the MkLinux installer should run.
  449.  
  450.  
  451. Once you are in the MkLinux Installer
  452. =====================================
  453.  
  454. The MkLinux installer is adapted from the well-known "Red Hat Linux"
  455. installer, originally written by Red Hat Software.  The installer was ported
  456. to MkLinux with the intent of making as few changes as possible.  Therefore,
  457. you will probably notice that there are still many references to "Red Hat
  458. Linux".  Also, there are some concepts presented that are appropriate for
  459. other Linux installations, but inappropriate for MkLinux.  Don't worry; with
  460. some basic instruction, you will be able to use the installer to get your
  461. MkLinux system installed with the desired collection of packages.
  462.  
  463. When you get to the first page of the installer, you should see a blue back-
  464. ground and a white text window with black characters.  If you don't get these
  465. colors, you may want to reboot into Mac OS and use the "Monitors and Sound"
  466. control panel to choose a 256-color scheme.
  467.  
  468. The following keys will help you navigate while using the installer:
  469.  
  470.     Tab             Move to the next field
  471.     Return          Select the current highlighted choice
  472.     Up/Down Arrow   Move up/down in a list of items
  473.     Space           Check or Uncheck the selected list item
  474.  
  475. Below is a step-by-step description of the various installation screens.
  476.  
  477.  "Welcome to MkLinux" Screen
  478.  
  479.      Simply press Return to continue to the next screen.
  480.  
  481.  "Keyboard Type" Screen
  482.  
  483.      Select a keyboard type.  This controls the keyboard mapping.  Not all
  484.      the listed keyboard mappings work properly.  If you find this is the
  485.      case for your selection, start over and select "us" as your keyboard
  486.      type.  You should be able to continue through the installation.
  487.  
  488.  "Installation Method" Screen
  489.  
  490.      Since the packages to be installed reside on the CD, choose "Local
  491.      CD-ROM".
  492.  
  493.  "Installation Path" Screen
  494.  
  495.      Choose "Install".  The other option, "Upgrade", is intended to add
  496.      packages to an already installed Red Hat system, and is not supported
  497.      in this release.
  498.  
  499.  "Partition Disks" Screen
  500.  
  501.      The installer will show you a list of disks on your system that MkLinux
  502.      has recognized.  If you select one and choose "Edit", you will be able
  503.      to view and optionally change that disk's partition map using the
  504.      MkLinux version of pdisk.  When you have finished viewing/editing the
  505.      partition maps on various disks, choose "Done".
  506.  
  507.      (Don't confuse this screen with the upcoming "Partition Disk" screen.)
  508.  
  509.  "Select Root Partition" Screen
  510.  
  511.      The installer will list every partition that is appropriate for an
  512.      MkLinux filesystem.  Pick one to use for your "root" partition.
  513.  
  514.      Only partitions of type "Apple_UNIX_SVR2" are shown.  Also, any
  515.      partitions you designated as swap partitions (by putting the word "swap"
  516.      in the name) will not be shown.
  517.  
  518.  "Partition Disk" Screen
  519.  
  520.      This page will list the other partitions that are available to be
  521.      mounted.  Use the arrow keys to highlight a particular partition, then
  522.      press Return.  A follow-on dialog will tell the installer where you
  523.      would like to have the filesystem in that partition mounted.  You may
  524.      also use this page to mount your Mac OS Standard (HFS) volumes.  Please
  525.      note, however, that the HFS volumes will be mounted read-only.
  526.  
  527.      Any MkLinux partitions you designated as swap partitions (by putting
  528.      the word "swap" in the name) will not be shown.
  529.  
  530.      (Don't confuse this screen with the previous "Partition Disks" screen.)
  531.  
  532.  "Active Swap Space" Screen
  533.  
  534.      The installer will give you a list of every partition that is suitable
  535.      to be a MkLinux swap partition.  Remember, use the Space bar to
  536.      set/unset which partitions you want to use for swap.
  537.  
  538.  "Find installation files" Screen
  539.  
  540.      This isn't a real screen.  However, you may notice a significant pause
  541.      here.  Be patient; if you have a relatively slow CD-ROM drive, you may
  542.      need to wait a few minutes.
  543.  
  544.  "Format Partitions" Screen
  545.  
  546.      The installer will give you a list of partitions.  You will need to use
  547.      the arrow keys and space bar to select which partitions to format.  If
  548.      you have never used MkLinux in these partitions, you must reformat all
  549.      of them.  If you have used MkLinux DR2.1 (or an earlier version), we
  550.      suggest that you reformat _all_ your MkLinux partitions.  If you have
  551.      used MkLinux "pre-DR3", we suggest that you format at least the system
  552.      partitions, such as / (the root partition), /usr, or /var.
  553.  
  554.  "Components to Install" Screen
  555.  
  556.      At this point, the installer will present you with a list of selected
  557.      collections of packages.  Use the Space bar to select the ones that
  558.      seem appropriate for your installation.
  559.  
  560.      At the very end of the list, there is an item labelled "Everything".
  561.      Selecting "Everything" will install every package (all 420 of them!)
  562.      available in the main package set, even those not represented in the
  563.      other groups.
  564.  
  565.      There is also a box that you can check labelled "Select individual
  566.      packages".  If this box is checked when you leave this screen, you will
  567.      go to a set of screens where you can select the packages individually.
  568.  
  569.  "Install log" Screen
  570.  
  571.      This is just an informative message explaining that an installation log
  572.      will be saved and will be viewable after the installation in the file
  573.      "/tmp/install.log".
  574.  
  575.  "Install System" Screens
  576.  
  577.      At this point, the installer will proceed to create the filesystems in
  578.      your MkLinux partitions, then install the packages that you selected.
  579.      A progress bar will be displayed, along with estimates of how much time
  580.      it will take to complete installing the packages.
  581.  
  582.      There are a few packages that write to the installer screen, making the
  583.      display somewhat messy.  You may safely ignore these messages.
  584.  
  585.  "Configure Mouse" Screen
  586.  
  587.      Choose ADB Mouse.  Note: the "emulate three buttons" option is not
  588.      applicable in MkLinux at this time.
  589.  
  590.  "Network Configuration" Screen
  591.  
  592.      If your MkLinux system is connected to a TCP/IP-based Local Area
  593.      Network, and you want to configure your system to operate on this
  594.      network at this time, choose "Yes".
  595.  
  596.      The installer will bring up two screens, the first is the "Configure
  597.      TCP/IP" screen.  You will need to know an IP address for your system,
  598.      the Net Mask, a Default Gateway address, and a DNS nameserver address.
  599.      If you don't know these values, you should ask your Network
  600.      Administrator.
  601.  
  602.      Checking "Configure device with bootp" (with the Space bar) indicates
  603.      that you want to query the network for a set of values appropriate for
  604.      your machine.
  605.  
  606.      The "Configure Network" screen allows you to enter your domain name and
  607.      host name.  Also, if you have any alternate nameservers, you should
  608.      enter them here.
  609.  
  610.  "Configure Timezones" Screen
  611.  
  612.      This is the place to set your local timezone.  Use the up and down
  613.      arrow keys to select the correct timezone from the list.
  614.  
  615.      You should always check the "Hardware clock set to GMT" box if you want
  616.      MkLinux to read your Mac OS clock correctly.  Don't worry; this will
  617.      not affect your Mac OS clock in any way.
  618.  
  619.  "Services" Screen
  620.  
  621.      The installer will present a list of the services that can be started
  622.      automatically when your MkLinux system boots.  If you are not familiar
  623.      with which services you want and which ones you don't want, it is safe
  624.      to simply leave the checkboxes unchanged.
  625.  
  626.  "Configure Printer" Screen
  627.  
  628.      If you choose "Yes" on this screen, the installer will present you with
  629.      a few more screens asking fairly straight-forward questions about your
  630.      printer.  Please note that, at this time, you cannot set up an
  631.      AppleTalk printer using this mechanism.
  632.  
  633.  "Root Password" Screen
  634.  
  635.      You must pick a password for the "root" account.  Remember this
  636.      password, because the "root" account will be the first thing you need
  637.      once the MkLinux installation is complete.  Note that when you type the
  638.      password, the characters do not appear.
  639.  
  640.  "Info" Screen
  641.  
  642.      Be sure to remember or write down the "rootdev" value that the
  643.      installer tells you on this screen.  You will need it in a few steps.
  644.  
  645.  "Done" Screen
  646.  
  647.      When you press ok, the system will reboot.  You will need to go into
  648.      Mac OS at least one more time to change the rootdev setting (mentioned
  649.      in the previous screen).
  650.  
  651.      When the system reboots, the MkLinux "Splash Screen" will appear again.
  652.      Select "Mac OS".  Once Mac OS has booted, invoke the MkLinux Control
  653.      Panel.  Press the "Custom..." button in the control panel.  The
  654.      SimpleText editor will be launched and you will be editing the
  655.      "lilo.conf" file.  Change the line that contains "rootdev=/dev/XXXX" to
  656.      the value that the installer gave you.  Save the file and quit.
  657.  
  658.      This is a good time to choose your "Startup Selection".  Click the
  659.      button next to either Mac OS or MkLinux.  (This sets the default choice
  660.      at the MkLinux Splash Screen.  At the splash screen, you can always
  661.      override the default choice.)
  662.  
  663.      Close the MkLinux Control Panel and restart your Macintosh.  Choose
  664.      MkLinux.  (If MkLinux is the default OS, you may simply choose to wait
  665.      10 seconds.)  MkLinux should now boot, placing you at the "login
  666.      prompt".
  667.  
  668.  
  669. Getting started with MkLinux
  670. ============================
  671.  
  672. Now that you have Mklinux installed, you'll want to start using it to do
  673. useful and fun things.  It is not possible for us to describe here everything
  674. that you can do with MkLinux.  For more assistance with using MkLinux (or
  675. practically any Linux system), please see the references below.  For now, here
  676. are a few simple things that you can do with MkLinux to get started.
  677.  
  678. Logging in as root
  679. ------------------
  680.  
  681.     At the "login:" prompt, type "root" then return and enter root's
  682.     password at the password prompt.  (Root's password is the one you chose
  683.     during the installation process.)
  684.  
  685.     In general, you should use the root account to do system administration
  686.     only.  For instance, you would want to use the root account to add
  687.     packages, remove packages, configure your networking, and in some cases
  688.     shut the system down.  For day-to-day operation of your MkLinux system,
  689.     you should create and use a user account for yourself.
  690.  
  691. Creating a user account
  692. -----------------------
  693.  
  694.     Log in as root and use the "adduser" command.  For instance, if you want
  695.     to create an account for Joe, you would issue the command:
  696.  
  697.         adduser joe
  698.  
  699.     This will create an account for joe, along with an associated home
  700.     directory "/home/joe".
  701.  
  702.     Joe's account will need to have an initial password.  Still as root,
  703.     issue the following command:
  704.  
  705.         passwd joe
  706.  
  707.     You will be prompted to enter an initial password for Joe's account.
  708.  
  709. Mounting the CD
  710. ---------------
  711.  
  712.     If you want to add some packages or access files from the MkLinux DR3
  713.     CD, you will first need to "mount" the CD.  While logged in as root,
  714.     issue the following command:
  715.  
  716.         mount -r -t iso9660 /dev/cdrom /mnt/cdrom
  717.  
  718.     The CD is now mounted and accessible in your filesystem directory tree
  719.     under /mnt/cdrom.  If you issue the commands:
  720.  
  721.         cd /mnt/cdrom
  722.         ls
  723.  
  724.     You will see the contents of the top directory on the CD.
  725.  
  726.     Once you have finished accessing the files on the CD, you will need to
  727.     "unmount" the CD before you can remove it from the CD-ROM drive.  Issue
  728.     the following commands (as root):
  729.  
  730.         cd                      # Change directory to be outside /mnt/cdrom
  731.         umount /mnt/cdrom
  732.  
  733. Installing a package
  734. --------------------
  735.  
  736.     There are two separate directories on the MkLinux DR3 CD that contain
  737.     packages that you can install.  Assuming that you mounted the CD under
  738.     /mnt/cdrom, the main packages directory will be here:
  739.  
  740.         /mnt/cdrom/RedHat/RPMS
  741.  
  742.     The extra packages will be here:
  743.  
  744.         /mnt/cdrom/extra/RPMS
  745.  
  746.     For example, if you want to install the "zsh" package, you should issue
  747.     the following commands (as root):
  748.  
  749.         cd /mnt/cdrom/RedHat/RPMS      # change directory to the packages dir
  750.         rpm -ihv zsh-3.0.5-1b.ppc.rpm  # install the zsh package
  751.  
  752.     A complete listing and description of the main packages is in the file:
  753.  
  754.         /mnt/cdrom/RedHat/rpmcontents.gz
  755.  
  756.     Similarly, there is a listing of the extra packages:
  757.  
  758.         /mnt/cdrom/extras/rpmcontents.gz
  759.  
  760.     These rpmcontents files are compressed text files.  To view them, issue
  761.     a command such as this:
  762.  
  763.         zless /mnt/cdrom/RedHat/rpmcontents.gz
  764.  
  765. Removing a package
  766. ------------------
  767.  
  768.     You can remove packages easily.  For instance, if you had installed the
  769.     "inn" package (The Internet News System) during the initial installation,
  770.     and now you realize that you do not intend to run Usenet news service on
  771.     your MkLinux system, then you might want to remove the inn package.  As
  772.     root, issue the command:
  773.  
  774.         rpm -e inn
  775.  
  776. Starting the X Window System:
  777.  
  778.     You may start X, the graphics system popular with practically every Unix
  779.     system, by issuing the command:
  780.  
  781.         startx
  782.  
  783.     Typically, you would run X from your regular user account.
  784.  
  785.  
  786. Where to go next
  787. ================
  788.  
  789. Books
  790. -----
  791.  
  792.   MkLinux - Microkernel Linux for the Power Macintosh
  793.  
  794.     Prime Time Freeware (www.ptf.com) publishes book/CD collections of
  795.     Open Source software.  At the request of Apple Computer, PTF created
  796.     a Reference Release for MkLinux.  The release contains information
  797.     on installing, using, and modifying the MkLinux system.
  798.  
  799.   Running Linux
  800.  
  801.     O'Reilly and Associates (www.oreilly.com) is a leading publisher of
  802.     books on Unix-related topics.  "Running Linux", although written with
  803.     standard Linux in mind, is a very useful supplement for the MkLinux
  804.     Reference Release.
  805.  
  806. Online
  807. ------
  808.  
  809.   www.mklinux.apple.com
  810.  
  811.   www.linux.org
  812.  
  813.  
  814. Thanks
  815. ======
  816.  
  817. This release of MkLinux would not have been possible without the efforts of
  818. many people.  We are grateful to everyone who has used, tested, reported bugs,
  819. made suggestions, or even submitted fixes to earlier versions of MkLinux.
  820. There are so many people involved, it would be impossible to list them all.
  821. However, there are a few individuals who have made significant contributions
  822. recently that have been extremely beneficial in the production of MkLinux
  823. Developer Release 3:
  824.  
  825. Mark Hatle (Mankato State University) ported the Red Hat Installer for use
  826. with MkLinux.  In doing so, he had to fix portions of MkLinux so that the
  827. Installer would operate correctly.  Mark has also assisted with the DR3 RPM
  828. package set.
  829.  
  830. Jack Howarth (University of Cincinatti College of Medicine) helped
  831. tremendously with the DR3 RPM package set.  From the earliest "pre-DR3"
  832. snapshot, hundreds of RPMs had to be updated, adjusted, or simply rebuilt.
  833. Jack's diligence in this area has made for an excellent package set.
  834.  
  835. Brad Midgley (Pacific HiTech, Inc.) ported some HFS code to work properly in
  836. the Mach Bootstrap task.  This is a key piece to getting the Red Hat installer
  837. running as the initial MkLinux installation is booted from an HFS filesystem.
  838.  
  839. James Pearson (University College London) modified mkisofs, yielding the
  840. utility "mkhybrid".  mkhybrid can create a CD-ROM image that has both ISO-9660
  841. and Apple HFS filesystem structures.  The MkLinux DR3 CD image was created
  842. with "mkhybrid".
  843.  
  844. Gary Thomas (The Open Group, Research Institute) has contributed far too many
  845. things to list that are directly applicable to MkLinux DR3.
  846.  
  847. And finally, we would like to thank the entire Linux/PPC team for their
  848. efforts in porting so many software packages.  In most cases these packages
  849. run unmodified on both Linux/PPC and MkLinux systems.
  850.  
  851.  
  852. Last words
  853. ===========
  854.  
  855. Be sure to check the MkLinux website:
  856.  
  857.     http://www.mklinux.apple.com/
  858.  
  859. for further information on current and future developments with MkLinux.
  860.  
  861. On behalf of everyone involved in making MkLinux Developer Release 3 a
  862. reality, we hope you find that MkLinux is both fun and useful.
  863.  
  864. The MkLinux Team
  865. Apple Computer
  866. July, 1998
  867.